Summary

Color variants (*Color) are SVG-only — their gradients cannot be represented in an icon font, so the font builds ship no color glyphs. Before this change, importing a Color icon under iconVariant: 'fonts' rewrote it to a nonexistent /fonts/<icon> atom, producing a broken import (export 'AddCircleColor' was not found).

The atomic loader now resolves variants per specifier and reroutes Color imports off color-less variants, so they always land on a build that actually ships color atoms.

Behavior

For a *Color import, the resolved variant follows the same iconVariant → fallbackVariant → svg precedence as module-level resolution, constrained to color-capable variants (svg, svg-sprite):

• Rerouting is per specifier, so import { AddFilled, AddCircleColor } under fonts splits into /fonts/add + /svg/add-circle.
• Headless-ness is preserved — the headless svg build also ships color atoms, so headless + fonts routes Color icons to /headless/svg/<icon>.
• svg-sprite already supports color, so those imports are left untouched.

Implementation

• Added a colorVariants field to ModuleDescriptor (parallels headlessVariants): react-icons → ['svg', 'svg-sprite'], react-brand-icons → ['svg'].
• Added resolveColorVariant() policy and isColorIconName() (derived from the canonical suffix regex).
• transform.ts now resolves per specifier with a ${module}:${isColor} cache key and dedupes diagnostics by message.

Tests & docs

• 10 new unit cases + color-fonts-imports and color-headless-fonts-imports webpack integration fixtures.
• README gains a Color icons section and a Mermaid resolution-flow diagram.
• All 49 unit tests + 15 integration fixtures pass; build and prettier are clean.